home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / slots12.zip / SLOTS.DOC < prev    next >
Text File  |  1992-11-01  |  10KB  |  225 lines
  1.          ************************************************************
  2.          ************************************************************
  3. ********** G  A  M  E  K  E  E  P  E  R      D  O  O  R  W  A  R  E *********
  4.          ************************************************************
  5.          ***********  Quality BBS Door Software for Less!  **********
  6.          ************************************************************
  7.  
  8.                           J A C K P O T    S L O T S
  9.                           ~~~~~~~~~~~~~    ~~~~~~~~~
  10.                                  Version 1.2
  11.  
  12.                         Copyright (c) Steve Sharpe 1992
  13.  
  14. SYSTEM REQUIREMENTS
  15. ~~~~~~~~~~~~~~~~~~~
  16. Any BBS capable of producing a standard DOOR.SYS file.
  17.  
  18. SYSTEM OPTIONS
  19. ~~~~~~~~~~~~~~
  20. Jackpot Slots supports the use of FOSSIL drivers and non-standard port
  21. addresses.  Refer to the INSTALLATION instructions for more information.
  22.  
  23. FILES CONTAINED IN SLOTS12.ZIP
  24. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25.      SLOTS.EXE     <-- The main program
  26.      SLOTS.DOC     <-- The file you are reading!
  27.      GAME.CFG      <-- The game configuration file
  28.      REVISION.DOC  <-- Revision notes
  29.  
  30. FILES CREATED BY SLOTS.EXE
  31. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32.      USER.DAT        <-- User data files.
  33.      JACKPOT.WIN     <-- File containing jackpot winners.
  34.  
  35. OVERVIEW
  36. ~~~~~~~~
  37.       JACKPOT SLOTS is a fairly authentic re-creation of a gambling casino
  38. progressive $1 slot machine.  The rules are simple...just deposit from 1 - 7
  39. dollars (if you have that many left!) into the machine.  Each dollar lights a
  40. payoff line.  As in real slots, you only win on the payoff lines that are lit.
  41. If you deposit more than 7 coins, the machine will return the excess coins.
  42. When ready, just pull on the handle and watch the wheels spin!  If you win,
  43. the payoff amount will be displayed and your winnings will fall into the
  44. machine tray.  Each player begins the game with $50 dollars in their bankroll.
  45. From then on, the game keeps track of your bankroll and saves the amount for
  46. use during future plays.  If you lose it all, your bankroll will reset to $50
  47. dollars.  The game also keeps track of the number of times you go broke!  You
  48. become a jackpot winner by getting 5 BARS in a row.  You can view jackpot
  49. winners (registered version only) or other players' current bankrolls from the
  50. menu.  Players can toggle the coin drop function on and off from a game
  51. options menu.  They can also select ANSI color or monochrome displays from the
  52. same menu.
  53.  
  54.       All payoffs are made by matching the slot machine windows in left to
  55. right order.  The following table reflects the payoff amounts for each
  56. symbol group:
  57.  
  58. CHERRIES          STRIPES           DOLLARS           BARS
  59. ~~~~~~~~          ~~~~~~~           ~~~~~~~           ~~~~
  60. 1 - $2            1 - $0            1 - $0            1 - $0
  61. 2 - $4            2 - $0            2 - $0            2 - $0
  62. 3 - $6            3 - $10           3 - $25           3 - $250
  63. 4 - $8            4 - $25           4 - $50           4 - $500
  64. 5 - $10           5 - $50           5 - $100          5 - $1000 (JACKPOT!)
  65.  
  66. NOTE:  Jackpot Slots supports both ANSI color graphics and ANSI monochrome
  67. applications, however, the door interfaces best with the user in ANSI color.
  68.  
  69. INSTALLATION
  70. ~~~~~~~~~~~~
  71. Jackpot Slots is easy to install.  Simply follow these steps:
  72.  
  73. 1.  'Unzip' the file SLOTS12.ZIP into the directory of your choice.  All files
  74. must remain in the same directory.
  75.  
  76. 2.  Edit the GAME.CFG configuration file according to the CONFIGURATION FILE
  77. section of these instructions using your favorite word processor.  Ensure you
  78. save them as ASCII text files.
  79.  
  80. 3.  Create or edit the batch file your BBS will use to activate the door.
  81. The main door program name is SLOTS.EXE.  For example, if you are running
  82. a Spitfire BBS, you would edit SF.BAT to look similar to the following:
  83.  
  84. :DOOR_A
  85.    REM Place Door A Commands Here
  86.    CD\SF\DOORS\SLOTS   <-- Change to the Jackpot Slots directory
  87.    SLOTS GAME.CFG      <-- The main program with configuration file argument
  88.    CD\SF               <-- Change back to the Spitfire directory
  89.    GOTO LOOP
  90.  
  91. NON-STANDARD PORT USE:  You may specify the use of non-standard communications
  92. ports with the PORT command.  The syntax for the PORT command is PORT:03E8:5,
  93. where 03E8 represents a different base address and 5 indicates the IRQ.  For
  94. example, the main program line in the example above would be changed to
  95. SLOTS GAME.CFG PORT:03E8:5 to reflect the use of a non-standard comm port.
  96.  
  97. FOSSIL DRIVER USE:  You may specify the use of a FOSSIL driver with the PORT
  98. command added to the main program command line.  The syntax for the PORT
  99. command is PORT:F:P, where F instructs the door to use a FOSSIL driver and P
  100. identifies the port.  For example, the main program line in the example above
  101. would be changed to SLOTS GAME.CFG PORT:F:1 if the SysOp wished to specify
  102. a FOSSIL driver on port 1.
  103.  
  104. NOTE:  The PORT command must be the third command in the main program command
  105. line, if used.  If not used, the door defaults to the use of the 4 standard
  106. communications ports (1-4) by reading the BBS file.
  107.  
  108. CONFIGURATION FILE
  109. ~~~~~~~~~~~~~~~~~~
  110. Entries in the GAME.CFG file must be accurate or the door cannot be expected
  111. to function properly.  Save your changes to the GAME.CFG file in ASCII text
  112. format.
  113.  
  114. The GAME.CFG file
  115. ~~~~~~~~~~~~~~~~~
  116. Jackpot Slots               <-- Line 1  (See below)
  117. c:\sf\door.sys              <-- Line 2    "     "
  118. The Gamekeeper's Lair       <-- Line 3    "     "
  119. Steve Sharpe                <-- Line 4    "     "
  120. 000000000000                <-- Line 5    "     "
  121.  
  122. Line 1 - This line reflects the name of the door.  The registration algorithm
  123. is based on some of this data.  DO NOT CHANGE LINE 1!
  124.  
  125. Line 2 - Enter the full path and filename for the BBS DOOR.SYS file.
  126.  
  127. Line 3 - Enter the name of your BBS.
  128.  
  129. Line 4 - Enter the SysOp's name.
  130.  
  131. Line 5 - Enter 12 zeros if the door is not registered.  Registered users enter
  132. the registration number provided by the author.  Other numbers will prevent
  133. the door from running.
  134.  
  135. REGISTRATION
  136. ~~~~~~~~~~~~
  137. The registration fee for Jackpot Slots is $15.  The unregistered door displays
  138. "EVALUATION COPY" upon entry and exit.  Please register or remove the door
  139. within 30 days of first use.  As a BBS SysOp, I understand how costly it can
  140. be to register BBS software.  I have purposely kept the cost of registering
  141. Jackpot Slots to a minimum with that thought in mind.  I believe the fee is
  142. quite reasonable, based on the many long hours of programming required.  Upon
  143. receipt of the registration fee, you will be provided with a unique
  144. registration number.  Once you insert the registration number into the GAME.CFG
  145. file, the "EVALUATION COPY" messages will be replaced with an opening and
  146. closing message that includes your BBS name.  Once the door is registered,
  147. players will be able to view all jackpot winners from the main menu inside the
  148. door.
  149.  
  150. COMMENTS/BUG REPORTS
  151. ~~~~~~~~~~~~~~~~~~~~
  152. I'm interested in all user comments and bug reports.  Please send your comments
  153. to:
  154.  
  155. Steve Sharpe                              Call The Gamekeeper's Lair BBS
  156. 1835 Stonetree Dr.              or        (208) 587-1105
  157. Mountain Home, ID 83647                   and leave a message
  158.  
  159.                                  Warranty
  160.                                ------------
  161.        This program has been thoroughly tested on a Spitfire 3.2 BBS,
  162.        however, it should perform equally well on any BBS that can
  163.        produce a standard DOOR.SYS file.
  164.  
  165.        I make no warranty of any kind, express or implied, including
  166.        without limitation, any warranties of merchantability and/or
  167.        fitness for a particular purpose.  I shall not be held liable for
  168.        any  damages, whether direct, indirect, special or consequential
  169.        arising from a failure  of this program to operate in the manner
  170.        desired by the user.  I shall not be held liable for any damage to
  171.        data or property which may be caused directly or indirectly by the
  172.        use of this program.
  173.  
  174.        In no event will I be held liable for any damages, including (but
  175.        not limited to) any lost profits, lost savings or other incidental
  176.        or consequential damages arising out of the use or inability to
  177.        use this program, or for any claim by any other party.
  178.  
  179.        This warranty is governed by the laws of the State of Idaho.
  180.                               REGISTRATION FORM
  181.                               -----------------
  182.  
  183.   Jackpot Slots                    Return to:  Steve Sharpe
  184.   Version 1.2                                  1835 Stonetree Dr.
  185.   Registration Fee: $15                        Mountain Home, ID 83647
  186.  
  187.   Name ______________________________________________________________
  188.  
  189.   Address ___________________________________________________________
  190.  
  191.           ___________________________________________________________
  192.  
  193.   Phone _____________________________________________________________
  194.  
  195.   Enter GAME.CFG file information below:
  196.  
  197.   BBS Name______________________________________________
  198.  
  199.   SysOp Name____________________________________________
  200.  
  201.   CHOOSE ONE OPTION BELOW:
  202.  
  203.   ____  I wish to download my registration number from The Gamekeeper's Lair
  204.         BBS at (208) 587-1105.  Enter the password you will use to log on to
  205.         The Gamekeeper's Lair BBS: _________________________________________
  206.         Enter your birthdate for pre-verification: _________________________
  207.         Please allow enough time for your registration fee to reach the author
  208.         before calling for your registration number.
  209.  
  210.   ____  I wish to have my registration number mailed to the address listed
  211.         above.
  212.  
  213.   Orders outside the USA add $2.00 . . . . . . . . . . . . _________
  214.  
  215.       Please find enclosed a check or money order for USA $_________
  216.   payable to Steve Sharpe.  This shows my support of Shareware products
  217.   and the Shareware concept.  It also shows my encouragement to help further
  218.   the development of BBS doors.
  219.  
  220.       I understand that Jackpot Slots is provided as-is and no warranties of
  221.   any kind, expressed or otherwise, are included and that I am using it at my
  222.   own risk.
  223.  
  224.   Signed: _________________________________________  Date: _________
  225.